Skip to main content

Form

Form Component overview

Imagine you are working the Contacts Table. This table stores the contact information about all the employees. You want to access the contact information about an existing employee. How will you do it?

Further, a new employee has joined the organisation. You wish to create a new item in the Contacts Table. How will you achieve this?

The Forms component enables you to :

  1. View the data in the table at the Items Level
  2. Create new data Items in the Data Table

The Form component allows you to add and arrange fields. You can consider this like a specialised-Grid Layout that works with table fields.

A Form component is among the fundamental components needed for Data Table functionality.

Please refer to How to configure Singular - Item Details for a step by step instruction on configuring a Form Component for a Table.

While a Form component is present by default on the Item Details Tab, you can add one or more Forms to Layouts/ Pages as needed.

How to set up Form component in Designer

  • You can add the Form component on to the Layout / Page. The Form component is present on the Item Details Tab (singular) by default.

    Form component in list

  • If the Form component is on a Grid Layout, you can resize and move the component over the layout. Also please note that within the Form component, you can resize and move the fields.

  • You can set the visibility of Form on the Details breakpoint. Also please note that setting Form invisible from Details breakpoint will hide all its fields as well.

    Visibility toggle

  • Within the Form component, you can set the visibility of individual fields on the Details breakpoint.

    Toggle the visibility on a form

  • You can set the visibility of Form on the Create Screen breakpoint. Also please note that setting Form invisible from Create Screen breakpoint will hide all its fields as well.

    Display toggle

  • Within the Form component, you can set the visibility of individual fields on the Create Screen breakpoint.

    Toggle display of a form

  • Within the Form, you can set whether a field is mandatory (required) to be filled on Create Screen breakpoint while adding a new Item to the Data Table.

    Mark a field as required in a form

  • As you add a Form component to a Layout / Page, it will appear as shown below:

    Blank form example

    • Please note the following two options:

1. Add all <Table_name> columns - If you click on this option, the Form component will include all the existing columns to it. (Please note - the system built-in columns would not be included)

Add all fields to a form adds everything

2. Configure - if you click on this option, the Form component will allow you to custom choose the columns you wish to add to the Form from the list of all columns. As you click on this option, a Form Fields panel will open.

Configure a form lets you select fields

  • You can also press the "+" on the Form configuration bar. This will also open the Form Fields panel.

    Adding fields using the + button

  • Within the Form Fields panel:

    • You can add a Label component with in the Form.

      Adding a label from the component picker

      • You can select all columns and deselect all columns in the Form Fields panel with a single click.

        Toggling selecting all fields

      • You can create new columns. By clicking this button from within the Form Fields panel you can navigate to Add Columns panel for the Data Table.

        Creating new column from a form

      • You need to click "Add to Form" button to add selected fields to the Form.

      Adding selected columns to the form

  • There can be occasions when you want to have two Form components to the same Layout / Page. In such a case, if you have added a few fields to the first Form Component, the system will give you option to add all the remaining (non-system built-in columns) to be added to the second Form Component.

    Adding remaining columns to a second form

Important points

  • The Form component is meaningful only on the Individual Item Level (singular). Although, you can add a Form component to the Item Group List level (Plural), but it gives a logical error message.

Error when viewing a form in a list

  • The Form component will refer to the subject Table only (on whose Design Tab you are adding the Form component).

  • You can add the same field more than once on a Form.

Adding the same field twice in a form

  • You can remove a field from the Form component by clicking on the "X" icon.

Removing a column component from a form

  • You can edit properties of a field in the Form by clicking on the Edit (pencil) icon. This will open the Edit Preferences panel for the field and based on the type of the field, it will provide you display options.

Editing a field from a form

Embedded Form component

Label component